home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr24 / dup21.zip / CHDK21.DOC < prev    next >
Text File  |  1993-04-08  |  12KB  |  365 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.                      C H D K
  20.  
  21.  
  22.  
  23.                    Version 2.1
  24.  
  25.  
  26.  
  27.                   Documentation
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.       CHDK   Copyright 1992, 1993   Chang Ping Lee   ALL RIGHTS RESERVED
  55.  
  56.  
  57.  
  58.       CHDK   Copyright 1992, 1993   Chang Ping Lee                  page  1
  59.  
  60.  
  61.  
  62.                   Table Of Contents
  63.  
  64.  
  65.       Disclaimer of warranty. . . . . . . . . . . . . . . . . . . .  2
  66.  
  67.       License . . . . . . . . . . . . . . . . . . . . . . . . . . .  3
  68.  
  69.       1.   Introduction . . . . . . . . . . . . . . . . . . . . . .  4
  70.  
  71.       2.   How to install and run CHDK. . . . . . . . . . . . . . .  5
  72.  
  73.       3.   How to use CONFIG.DCF. . . . . . . . . . . . . . . . . .  6
  74.  
  75.       4.   Meaning of some statistics . . . . . . . . . . . . . . .  7
  76.  
  77.  
  78.  
  79.       CHDK   Copyright 1992, 1993   Chang Ping Lee                  page  2
  80.  
  81.  
  82.  
  83.             DISCLAIMER  OF WARRANTY
  84.  
  85.  
  86.     THIS SOFTWARE AND MANUAL ARE SUPPLIED "AS IS." THE AUTHOR HEREBY
  87.     DISCLAIMS ALL WARRANTIES RELATING TO THIS SOFTWARE AND ITS
  88.     DOCUMENTATION FILE, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED
  89.     TO DAMAGE TO HARDWARE, SOFTWARE AND/OR DATA FROM USE OF THIS
  90.     PRODUCT. IN NO EVENT WILL THE AUTHOR OF THIS SOFTWARE BE LIABLE
  91.     TO YOU OR ANY OTHER PARTY FOR ANY DAMAGES. YOUR USE OF THIS
  92.     SOFTWARE INDICATES THAT YOU HAVE READ AND AGREE TO THESE AND
  93.     OTHER TERMS INCLUDED IN THIS DOCUMENTATION FILE.
  94.  
  95.  
  96.     DUE TO THE NATURE OF EVOLVING PROGRAMMING AND THE VARIOUS
  97.     HARDWARE AND SOFTWARE ENVIRONMENTS IN WHICH THIS SOFTWARE MAY
  98.     BE USED, IT IS UNDERSTOOD THAT OCCASIONAL "BUGS" OR UNFITNESS
  99.     MAY ARISE. THE USER SHOULD ALWAYS TEST THIS SOFTWARE THOROUGHLY
  100.     WITH NON-CRITICAL DATA BEFORE RELYING ON IT.
  101.  
  102.  
  103.  
  104.       CHDK   Copyright 1992, 1993   Chang Ping Lee                  page  3
  105.  
  106.  
  107.  
  108.                 LICENSE
  109.  
  110.  
  111.     1. In return for the payment of a one time fee, the customer is
  112.     granted a non-commercial or commercial license.
  113.  
  114.     2. If the registration is for a non-commercial license the customer
  115.     can use the software for personal backup or other usages in which
  116.     the customer make no profit and the duplicated diskettes of any
  117.     particular source diskette (or image file) are not distributed to
  118.     more than ten persons. In addition, the software may not be used in
  119.     any business, organization, institution or government agency.
  120.  
  121.     3. If the registration is for a commercial license the customer can
  122.     use the software in a business, organization, institution or
  123.     government agency, for profit or non-profit purposes. With a
  124.     commercial license the customer can distributed the duplicated
  125.     diskettes to as many persons as he or she likes
  126.  
  127.     4. The customer may use the product just-like-a-book which means
  128.     this software can be used by more than one person and can be moved
  129.     from one computer to another so long as there is NO POSSIBILITY of
  130.     it being used by two different persons on two different computers
  131.     at the same time, just like a book can not be read by two different
  132.     persons in two different places at the same time.
  133.  
  134.     5. This software and its documentation and all supplemental files
  135.     are property of the author and may not be duplicated for sale to
  136.     any third parties without written permission from the author.
  137.  
  138.     6. The customer agrees that this product is protected by United
  139.     States copyright law and international copyright treaty provisions.
  140.     Purchase of this license does not transfer any right, title or
  141.     interest in the product to the customer except as specifically set
  142.     forth in this license agreement.
  143.  
  144.     7. The author of this software product reserves the right to
  145.     terminate this license upon breach.
  146.  
  147.  
  148.  
  149.       CHDK   Copyright 1992, 1993   Chang Ping Lee                  page  4
  150.  
  151.  
  152.  
  153.     1. INTRODUCTION:
  154.  
  155.  
  156.        CHDK (CHeck DisKette) is a utility which gives detailed
  157.        information about a diskette. It shows you the information
  158.        contained in the system area of the diskette, check the
  159.        integrity of the system area, gives you detailed layout of
  160.        system area, root directory and data area and then give you a
  161.        report of the fragmentation on the diskette.
  162.  
  163.  
  164.        The program also shows you other important or interesting
  165.        information about a diskette. For example, it shows you the
  166.        sectors, clusters and tracks with active data, the software who
  167.        formatted the diskette, maximum number of root directory entries
  168.  
  169.  
  170.        All the information is packed in one screen.
  171.  
  172.  
  173.  
  174.       CHDK   Copyright 1992, 1993   Chang Ping Lee                  page  5
  175.  
  176.  
  177.  
  178.     2. HOW TO INSTALL AND RUN CHDK
  179.  
  180.  
  181.        Copy the EXE and DOC files to a directory created for DCF and
  182.        DUP. Define the PATH in your AUTOEXEC.BAT to include this
  183.        directory or the directory of a one-line batch file which
  184.        contains the path of CHDK.EXE.
  185.  
  186.  
  187.        You can specify the floppy drive on the command line. If no
  188.        drive is specified, drive A: will be checked.
  189.  
  190.  
  191.        If you only have one or two floppy drives you can skip the rest
  192.        of this section.
  193.  
  194.  
  195.        In systems with four floppy drives, the device driver is
  196.        required to run CHDK. Unlike other programs in the DISKETTE
  197.        UTILITY PACKAGE, CHDK relies on the driver to access floppy
  198.        disk. The device driver can be firmware on the controller or
  199.        in the form of TSR which needs to be installed in memory. Check
  200.        the instruction that came with the controller for more
  201.        information about the installation of the device driver.
  202.  
  203.  
  204.        if a device driver which came with the controller is installed
  205.        CHDK usually can detect the drive letters automatically and the
  206.        drive letters should be used to specify the third and fourth
  207.        drives. You can also provide the information on floppy drive
  208.        capacity by editing a text file, CONFIG.DCF.
  209.  
  210.  
  211.        The following is an example of the text file in which a 1.2MB,
  212.        a 1.44MB and a 360KB drives are specified as the first, the
  213.        second and the third drives with drive letters A: B: and G:,
  214.        respectively. The 0 on the last line indicates that the fourth
  215.        drive is not installed. If all drives are defined, such as in
  216.        the example, CHDK will not check with DOS for drive capacity.
  217.        This can speed up the initialization process.
  218.  
  219.        $DRIVE
  220.         1 1200 A:
  221.         2 1440 B:
  222.         3  360 G:
  223.         4    0
  224.  
  225.  
  226.  
  227.       CHDK   Copyright 1992, 1993   Chang Ping Lee                  page  6
  228.  
  229.  
  230.  
  231.     3. CONFIGURATION FILE AND COMMAND LINE ARGUMENTS
  232.  
  233.  
  234.        If you have read the DOC file of DCF you can skip this section
  235.        and continue at section 4.
  236.  
  237.  
  238.        In a three or four drive system or in case CHDK can not detect
  239.        drive capacity, you can specify the information in the
  240.        CONFIG.DCF file
  241.  
  242.  
  243.        $DRIVE : You don't need to provide this information except for
  244.             the following two cases. If the program fails to get
  245.             the correct drive capacity from your system or if you
  246.             want to access four drives without installing the
  247.             device driver which came with the controller you can
  248.             use this keyword to specify the drive capacity in the
  249.             CONFIG.DCF file.
  250.  
  251.             The next few lines contain parameters about diskette
  252.             drives in your system. On each line, the first number
  253.             specify the drive, 1 for drive A:, 2 for drive B:, 3
  254.             and 4 for third and fourth drives in a four drive
  255.             system. The second number is the drive capacity in KB.
  256.             A drive letter (optional) can be specified at the end.
  257.             See section 4 of DCF40F.DOC for details.
  258.  
  259.  
  260.        CHDK also uses the following options specified on CONFIG.DCF or
  261.        the command line.
  262.  
  263.        @file_name  specify alternative name for the configuration file.
  264.  
  265.        drive:  Specify a floppy drive for checking.
  266.  
  267.  
  268.        EXAMPLES:
  269.  
  270.  
  271.        CHDK A:        Check drive A:.
  272.  
  273.        CHDK 3:        Check the third drive, when device driver is not
  274.               installed.
  275.  
  276.        CHDK G:        Same as the last example, but in this case the
  277.               driver is installed and the drive letters is G.
  278.  
  279.  
  280.  
  281.       CHDK   Copyright 1992, 1993   Chang Ping Lee                  page  7
  282.  
  283.  
  284.  
  285.     4. MEANING OF SOME STATISTICS
  286.  
  287.  
  288.        CHDK provides detailed information about a diskette. Some of the
  289.        statistics is explained in this section. The numbers of sectors
  290.        CHDK shows you start at 0 and end at number of sectors minus
  291.        one. For example, 1.2MB disk contains 80 tracks each tracks has
  292.        two sides and there are 15 sectors on each side. Therefore, the
  293.        total number of sectors is 2400. CHDK uses 0 for the first
  294.        sector and 2399 for the last sector.
  295.  
  296.        FAT1 sectors, FAT2 sectors : DOS uses some sectors to store the
  297.        File Allocation table which is a linked list for files and
  298.        directories. CHDK shows you the directories which contain the
  299.        FAT. DOS keeps two copies of FAT and hence CHECK DISKETTE uses
  300.        the names FAT1 and FAT2.
  301.  
  302.        Root dir sec : Unlike other sub directories, the sectors which
  303.        contain the root directory is determined at the time the disk
  304.        was formatted. CHDK shows where they are.
  305.  
  306.        Data sectors : These are sectors for files and sub directories.
  307.  
  308.        Data clusters : Each cluster consists of one (1.2MB & 1.44 MB)
  309.        sector or two (360KB & 720KB) sectors. The numbers of clusters
  310.        starts at 2 and ends at number of cluster plus one.
  311.  
  312.        System ID : This shows you the software which formatted the
  313.        diskette. For example, if you use MS DOS to format the diskette
  314.        it will shows MSDOS followed by its version. There are other
  315.        softwares which format disk differently from DOS. Usually if
  316.        they write the boot sector using their own code they will also
  317.        put their names here.
  318.  
  319.        Root entries : Since the sectors for root directories is
  320.        determined at the time of formatting, the number of entries that
  321.        root directory can hold is predetermined. This shows you what
  322.        that number is.
  323.  
  324.        Max. data cluster, sector, track : This shows you the maximum
  325.        of data cluster, sector and track numbers which contain active
  326.        data. Note that if the track number is 20 then track 0 to track
  327.        20 contains active data. The total number of tracks with useful
  328.        information is 21 instead of 20.
  329.  
  330.        Table of diskette space allocation : Right before the report of
  331.        fragmentation there is a table which shows you the details of
  332.        the allocation of space of the diskette. Note that the
  333.        percentage is calculated by dividing the number of sectors by
  334.        total number of sectors which includes the system area. Other
  335.        programs may not take the system area into account.
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.        Fragmentation : If the clusters for storing a file or a sub
  345.        directory is not in sequence then the file or the sub directory
  346.        is considered fragmented. For example, if a file is stored in
  347.        clusters 2, 3, 8 and 10 CHDK will add 2 to the number of
  348.        fragmented clusters since there is a gap between cluster 3 and 8
  349.        and another gap between cluster 8 and 10. CHDK check every file
  350.        and sub directory on the diskette to get the total number of
  351.        fragmented clusters.
  352.  
  353.        Also reported is the percentage of fragmentation. Note that
  354.        there are different ways for calculating the percentage. On a
  355.        testing disk which contains 14 files in 2360 clusters, 5 of the
  356.        14 files contains total of 7 fragmented clusters. CHDK reports
  357.        0.3% fragmentation while a famous utility reports 36%
  358.        fragmentation. CHDK divides the number of fragmented cluster by
  359.        the total number of clusters used by directories, files and lost
  360.        cluster chains (7 divided by 2360) and get the 0.3% figure. The
  361.        other utility divides the number of files with fragmented
  362.        clusters by the total number of files (5 divided by 14) and get
  363.        the 36% figure. You decide which figure is closer to the truth.
  364.  
  365.